home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2001 May
/
SGI Freeware 2001 May - Disc 1.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
man
/
cat4
/
sendq.Z
/
sendq
Wrap
Text File
|
2000-06-09
|
28KB
|
527 lines
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
NNNNAAAAMMMMEEEE
sendq/q* - _H_y_l_a_F_A_X outbound job description
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Files in the sssseeeennnnddddqqqq directory specify transmission job
requests. These files are created by _h_f_a_x_d(1M), when
submitting a job on behalf of _s_e_n_d_f_a_x(1) or _s_e_n_d_p_a_g_e(1).
Job description files also reside in the ddddoooonnnneeeeqqqq directory;
they are moved there by _f_a_x_q(1M) when a job completes.
Job description files are ASCII files with lines of the form
ttttaaaagggg: _v_a_l_u_e
where a _t_a_g is one of the identifiers described below and a
_v_a_l_u_e is either a string or number. Values start at the
first non-blank character after the ``:'' and continue to
the end of the line. Lines that end with a backslash
character ``\'' are continued to the next line. Numeric
values are decimal integers, except for cccchhhhoooopppphhhhrrrreeeesssshhhhoooolllldddd which
is expressed as a floating point value.
The following table lists the possible tags and the required
type of the associated value.
TTTTaaaagggg TTTTyyyyppppeeee DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
chopthreshold float page chopping threshold (inches)
commid string communication identifier for last call
company string receiver's company
client string host that submitted the job
cover string continuation coverpage file
data string unprocessed document of indeterminate type
!data string processed document of indeterminate type
dataformat string data format used to transmit a facsimile
desiredbr integer desired transmit speed
desireddf integer desired page data format
desiredec integer desired use of Error Correction Mode (ECM)
desiredst integer desired minimum scanline time
desiredtl integer whether or not to use ttttaaaagggglllliiiinnnneeee parameter
donop string operation to perform when job is reaped
external string external form of dialstring
fax string document ready for transmission
groupid integer _H_y_l_a_F_A_X job group identifier
jobid integer _H_y_l_a_F_A_X job identifier
jobtag string user-specified job identifier
jobtype string job type identification string
killtime integer time to give up trying to send job
location string receiver's location
mailaddr string email address of sender
maxdials integer max number of times to dial
maxtries integer max number of attempts to send job
minsp integer minimum required transmit speed
modem string outgoing modem to use
ndials integer number of consecutive failed attempts to place call
Page 1 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
notify string email notification specification
npages integer number of pages transmitted
ntries integer number of attempts to send current page
number string dialstring to use in placing call
owner string user that owns the job
page string PIN in a page operation
pagechop string whitespace truncation handling
pagehandling string page analysis information
pagelength integer facsimile page length (millimeters)
pagewidth integer facsimile page width (millimeters)
passwd string info to send in HDLC PWD frame
pcl string unprocessed PCL document
!pcl string processed PCL document
poll string polling request
postscript string unprocessed POSTSCRIPT document
!postscript string processed POSTSCRIPT document
priority integer user-specified scheduling priority
receiver string receiver's identity
resolution integer vertical resolution of facsimile
retrytime integer time to use between job retries
schedpri integer current scheduling priority
sender string identity of sender
signalrate string signalling rate at which a facsimile was sent
state integer job scheduling state
status string job status
subaddr string info to send in HDLC SUB frame
tagline string tagline format string
tiff string unprocessed TIFF/F document
!tiff string processed TIFF/F document
totdials integer total number of phone calls
totpages integer total pages to transmit
tottries integer total number of attempts to send job
tts integer time to send job
useccover integer whether or not to use a continuation cover page
PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
Note that all files must be owned by the fax user.
Pathnames for document files must be relative to the top of
the _H_y_l_a_F_A_X spooling directory and not include ``..''.
cccchhhhoooopppptttthhhhrrrreeeesssshhhhoooolllldddd The minimum trailing whitespace (in inches)
that must appear on a page for it to be
considered for ``page chopping''. If this
parameter is not specified then the value
specified by the PPPPaaaaggggeeeeCCCChhhhooooppppTTTThhhhrrrreeeesssshhhhoooolllldddd
configuration parameter is used; see
_c_o_n_f_i_g(4F).
ccccoooommmmmmmmiiiidddd The communication identifier for the last
outbound call placed for this job. This
string is of the form ``XXXXXXXX'' where
XXXXXXXX is a decimal sequence number in the
Page 2 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
range 1-99999999.
cccclllliiiieeeennnntttt The fully qualified hostname for the machine
from which the job was submitted. If the
hostname is unknown at the time the job is
submitted, then the host address in Internet
standard ``.'' (dot) notation is supplied
instead.
ccccoooommmmppppaaaannnnyyyy The receiver's company name as specified with
the ----xxxx option to _s_e_n_d_f_a_x(1). This value is
used only when creating continuation cover
pages.
ccccoooovvvveeeerrrr The pathname of a _c_o_n_t_i_n_u_a_t_i_o_n _c_o_v_e_r _p_a_g_e to
send. The file must be TIFF/F (i.e. it must
already be prepared for transmission). This
document will be transmitted before any other
documents listed in the file. See
CCCCoooonnnnttttCCCCoooovvvveeeerrrrPPPPaaaaggggeeee and CCCCoooonnnnttttCCCCoooovvvveeeerrrrCCCCmmmmdddd in _c_o_n_f_i_g(4F).
ddddaaaattttaaaa The pathname of a document to send. Once a
document has been processed, it is marked as
!!!!ddddaaaattttaaaa so that subsequent retries do not
reprocess the document.
ddddaaaattttaaaaffffoooorrrrmmmmaaaatttt The format used to transmit facsimile data.
This item is recorded by _f_a_x_s_e_n_d(1M) so that
_n_o_t_i_f_y(1M) can return it in a notification
message.
ddddeeeessssiiiirrrreeeeddddbbbbrrrr The desired signalling rate to use for page
data transmissions: 0 for 2400 bps, 1 for
4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4
for 12000 bps, and 5 for 14400 bps (default).
ddddeeeessssiiiirrrreeeeddddddddffff The desired data format to use for page data
transmissions: 0 for 1-D MR, 1 for 2-D MR, 3
for 2-D MR with uncompressed data, and 4 for
2-D MMR (default).
ddddeeeessssiiiirrrreeeeddddeeeecccc Whether or not to negotiate the use of Error
Correction Mode (ECM): 0 to disable, 1 to
enable (default).
ddddeeeessssiiiirrrreeeeddddsssstttt The desired minimum scanline time to use for
page data transmissions: 0 for 0 ms
(default), 1 for 5 ms, 2 for 10ms/5ms, 3 for
10ms, 4 for 20ms/10ms, 5 for 20ms, 6 for
40ms/20ms, and 7 for 40ms. This value is used
in selecting the negotiated session
parameters.
Page 3 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
ddddeeeessssiiiirrrreeeeddddttttllll Whether or not to use the format string
specified by the ttttaaaagggglllliiiinnnneeee job parameter when
imaging taglines on document pages. If this
value is non-zero then per-job format string
is used; otherwise the tagline format string
specified in the server configuration file is
used; see TTTTaaaaggggLLLLiiiinnnneeeeFFFFoooorrrrmmmmaaaatttt in _c_o_n_f_i_g(4F).
ddddoooonnnneeeeoooopppp The treatment the job should be given when it
is processed by the _f_a_x_q_c_l_e_a_n(1M) job cleaner
program. The may be one of _r_e_m_o_v_e (to expunge
the job description file and all associated
documents that are not referenced by another
job) or _a_r_c_h_i_v_e (to request that the job and
associated documents be archived on the server
machine). Consult _f_a_x_q_c_l_e_a_n more details on
other information that may be included in this
string.
eeeexxxxtttteeeerrrrnnnnaaaallll The external form of the dialstring. This
string is used instead of the dialstring in
any status and log messages. Clients can
protect private information such as access
codes that must be placed in dialstrings by
supplying a ``cleansed'' version of the
dialstring.
ffffaaaaxxxx The pathname of a TIFF/F document that is
ready for transmission. If the pathname
string has a leading ``xx:'', then ``xx'' is
interpreted to be the index of the first
directory in the file to transmit (directories
are numbered starting at zero).
ggggrrrroooouuuuppppiiiidddd The job group identifier, an integer number in
the range 1 to 32000 assigned to each group of
jobs by the _H_y_l_a_F_A_X software. Each job in a
group of jobs submitted at the same time is
assigned the same value by the _H_y_l_a_F_A_X
software.
jjjjoooobbbbiiiidddd The job identifier, a unique integer number in
the range 1 to 32000 assigned to each job by
the _H_y_l_a_F_A_X software.
jjjjoooobbbbttttaaaagggg A user-specified string that is intended for
identification purposes. If this string is
defined, it is returned to the user in
notification messages instead of the job
identifier.
kkkkiiiillllllllttttiiiimmmmeeee The time to kill this job, expressed in
Page 4 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
seconds since 00:00:00 GMT, January 1, 1970.
llllooooccccaaaattttiiiioooonnnn The receiver's location as specified with the
----yyyy option to _s_e_n_d_f_a_x(1). This value is used
only when creating continuation cover pages.
mmmmaaaaiiiillllaaaaddddddddrrrr The electronic mail address to which
notification messages should be directed.
mmmmaaaaxxxxddddiiiiaaaallllssss The maximum number of times the server should
dial the phone. If the job cannot be
completed in this number of calls, it is
terminated.
mmmmaaaaxxxxttttrrrriiiieeeessss The maximum number of times the server should
attempt to send a job; where an attempt is
defined to be a session that makes it past
Phase A of the CCITT T.30 protocol (for
facsimile), or similar. If the job cannot be
completed in this number of tries, it is
terminated.
mmmmiiiinnnnsssspppp The minimum signalling rate to use for
transmitting page data: 0 for 2400 bps
(default), 1 for 4800 bps, 2 for 7200 bps, 3
for 9600 bps, 4 for 12000 bps, and 5 for 14400
bps.
mmmmooooddddeeeemmmm The outgoing modem to use to send the job, or
``any'' if any available modem is acceptable.
oooowwwwnnnneeeerrrr The identity of the user that owns the job.
Typically the owner is the user that created
the job, though clients with administrative
privileges can change the ownership of jobs.
The value is the string specified in the USER
command passed to _h_f_a_x_d(1M) when a client
logins in to the server.
nnnnoooottttiiiiffffyyyy A specification of whether the sender wants
notification: whenever the job is requeued
after a failed attempt to transmit (``_w_h_e_n
_r_e_q_u_e_u_e_d''), when the job is completed (``_w_h_e_n
_d_o_n_e''), either of the above (``_w_h_e_n
_d_o_n_e+_r_e_q_u_e_u_e_d''), or not at all (``_n_o_n_e'').
nnnnppppaaaaggggeeeessss The number of pages in the facsimile,
including the cover page, that have been
successfully transmitted.
nnnnttttrrrriiiieeeessss The number of unsucessful attempts that have
been made to transmit the current page.
Page 5 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
nnnnddddiiiiaaaallllssss The number of consecutive unsucessful attempts
to establish carrier with the the remote
device.
nnnnuuuummmmbbbbeeeerrrr The dialstring to use to call the destination
device.
ppppaaaaggggeeee a string with PIN and to use in processing a
page transmit request.
ppppaaaaggggeeeecccchhhhoooopppp Whether or not to automatically truncate
trailing whitespace on pages of outbound
facsimile; see PPPPaaaaggggeeeeCCCChhhhoooopppp in _c_o_n_f_i_g(4F). The
possible values are: ``_d_e_f_a_u_l_t'' to use the
setting of the PPPPaaaaggggeeeeCCCChhhhoooopppp configuration
parameter, ``_n_o_n_e'' to disable page chopping,
``_a_l_l'' to enable chopping of all pages, and
``_l_a_s_t'' to enable chopping of the last page
of each document.
ppppaaaaggggeeeehhhhaaaannnnddddlllliiiinnnngggg A string that contains per-page information
used during facsimile transmission. Most of
the information is used in the negotiation of
session capabilities with optional information
used in the implementation of page chopping.
The string has three characters, say _x_x_c, for
each page to be transmitted. The _x_x
characters are a hex-encoded specification of
the session capabilities required to transmit
the page. The _c character is one of ``M'',
``S'', and ``P''; where: ``M'' indicates there
is another page to follow and that the page
requires different T.30 session parameters be
negotiated (an EOM code is to be transmitted).
``S'' indicates there is another page to
follow, but the page uses the same session
parameters (an MPS. code is to be
transmitted). ``P'' indicates this is the
last page to be transmitted (an EOP code is to
be transmitted). In addition, if page
chopping has been enabled and the page has
enough trailing whitespace to be a candidate,
then each three character string will be
followed by a string of the form ``_Z_X_X_X_X'',
where ``XXXX'' is a 4 digit hex-encoded count
of the number of bytes of data to send for a
chopped page.
ppppaaaaggggeeeelllleeeennnnggggtttthhhh The desired page length in millimeters.
ppppaaaaggggeeeewwwwiiiiddddtttthhhh The desired page width in millimeters.
Page 6 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
ppppccccllll The pathname of a PCL document to send. Once
a PCL document has been processed by _f_a_x_s_e_n_d,
it is marked as !!!!ppppccccllll so that subsequent
retries do not reprocess the document.
ppppoooollllllll The value is a Caller Identification String
(CIS) to use in making a polling request. If
no CIS is specified then _f_a_x_s_e_n_d will form one
from the FFFFAAAAXXXXNNNNuuuummmmbbbbeeeerrrr configuration parameter.
ppppoooossssttttssssccccrrrriiiipppptttt The pathname of a POSTSCRIPT document to send.
Once a POSTSCRIPT document has been processed
by _f_a_x_s_e_n_d, it is marked as !!!!ppppoooossssttttssssccccrrrriiiipppptttt so
that subsequent retries do not reprocess the
document.
rrrreeeecccceeeeiiiivvvveeeerrrr The receiver's name. This value is used only
when creating continuation cover pages.
rrrreeeessssoooolllluuuuttttiiiioooonnnn The desired vertical resolution in lines per
inch. This value should be either 98 or 196.
retrytime The time, in seconds, to delay between each
attempt to transmit a job that fails because
of a communication-oriented problem. Normally
jobs are scheduled according to a collection
of configuration parameters that are tuned for
the specific reason of each failure; e.g. see
JJJJoooobbbbRRRReeeeqqqqPPPPrrrroooottttoooo in _c_o_n_f_i_g(4F).
sssseeeennnnddddeeeerrrr The ``full name'' of the sender of the
facsimile.
ssssiiiiggggnnnnaaaallllrrrraaaatttteeee The signalling rate used to transmit facsimile
data. This item is recorded by _f_a_x_s_e_n_d(1M) so
that _n_o_t_i_f_y(1M) can return it in a
notification message.
ssssttttaaaatttteeee The job scheduling state. Recognized values
are: 1 (_s_u_s_p_e_n_d_e_d, not being scheduled), 2
(_p_e_n_d_i_n_g, waiting for the time to send), 3
(_s_l_e_e_p_i_n_g, waiting for a scheduled timeout), 4
(_b_l_o_c_k_e_d, waiting for concurrent activity to
the same destination to complete), 5 (_r_e_a_d_y,
ready to be processed except for available
resources), 6 (_a_c_t_i_v_e, actively being
processed by _H_y_l_a_F_A_X), 7 (_d_o_n_e, processing
completed).
ssssttttaaaattttuuuussss Status information about the current state of
the job. Typically this is the reason why the
last attempt to send the facsimile failed.
Page 7 (printed 3/21/00)
SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF))))
ssssuuuubbbbaaaaddddddddrrrr The SubAddress information to transmit when
sending a facsimile. This string should be
used by the receiver to route received
facsimile documents.
ttttaaaagggglllliiiinnnneeee The format string to use in imaging taglines
on outgoing documents. Note that this
parameter is only used if the ddddeeeessssiiiirrrreeeeddddttttllll
parameter is non-zero.
ttttiiiiffffffff The pathname of a TIFF/F document to send.
Once a TIFF document has been processed by
_f_a_x_s_e_n_d, it is marked as !!!!ttttiiiiffffffff so that
subsequent retries do not reprocess the
document.
ttttoooottttddddiiiiaaaallllssss The total number of times the server has
placed a call to the receiving phone number.
ttttoooottttppppaaaaggggeeeessss The total number of pages to be transmitted.
ttttoooottttttttrrrriiiieeeessss The total number of attempts to transmit a
job; see mmmmaaaaxxxxttttrrrriiiieeeessss above.
ttttttttssss The time to send the job. If this value is
non-zero, it is number of seconds since
00:00:00 GMT, January 1, 1970. Otherwise, a
value of 0 is interpreted to mean process as
soon as possible.
uuuusssseeeeccccccccoooovvvveeeerrrr 1 if the job should use a continuation cover
page during retransmission, 0 otherwise. See
_h_y_l_a_f_a_x(4F) for a description of continuation
cover pages.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
_s_e_n_d_f_a_x(1), _f_a_x_q(1M), _f_a_x_q_c_l_e_a_n(1M), _f_a_x_s_e_n_d(1M),
_p_a_g_e_s_e_n_d(1M), _h_f_a_x_d(1M), _c_o_n_f_i_g(4F)
Page 8 (printed 3/21/00)